長い関数(Code Smell)
間接層を設けることによるメリット(コードの自己記述性、共有性、選択可能性)は、まさに小さな関数によって実現されるのです。(Kindle の位置No.2181-2182)
コメントが必要と感じたら、代わりに分割する
コメントが必要な関数には、内部でどのように処理をしているかではなく、そのコードが何をするのかという「意図」を示した名前を付けるようにします。(Kindle の位置No.2191-2193)
意図を示した名前
既存のコメントを手がかりに分割していく
たとえ1行だったとしても、説明のために分割する価値はあります。(Kindle の位置No.2209-2210)
(感想:自己文書化!)